home *** CD-ROM | disk | FTP | other *** search
/ PD Collection CD 1 / PD Collection CD 1.iso / utils3 / viewfind / ReadMe
Text File  |  1993-05-15  |  10KB  |  345 lines
  1.  
  2. Here's !View+Find after I did some reading on font handling
  3.  
  4. Now it comes with three templates files:
  5.  
  6. --------
  7. high`res
  8. --------
  9. Will be used in high resolution modes if in the !Run file you say
  10.  
  11. hires`templates = TRUE
  12.  
  13. -------
  14. low`res
  15. -------
  16. Will be used in low resolution modes if in the !Run file you say
  17.  
  18. lores`templates = TRUE
  19.  
  20. --------
  21. sys`font
  22. --------
  23. Will be used instead of the above when you say something different
  24.  
  25.  
  26. high`res contains !View+Find's templates with text in an anti-aliased font
  27. which looks good in hires modes
  28.  
  29. low`res contains the same templates with text in an anti-aliased font which
  30. looks good in lores modes
  31.  
  32. sys`font contains a 3rd copy of !View+Find's templates with text in system font
  33. which looks bad at any resolution except mode 3 which wimp doesn't like
  34.  
  35. So high`res is 16 points Trinity.Medium
  36.    low`res     10 points Portrhouse.Standard
  37.  
  38. and of course, you can change everything except for the sizes of the
  39. indirected data buffers (if you do you'll also need to re-DIM one line
  40. in !RunImage)
  41.  
  42. As I already said, if one of the ..res`templates vars is FALSE the
  43. sys`font templates will be used in the .. resolution modes
  44.  
  45. The file though will always be displayed in the system font
  46.  
  47. The system variable V+F$Templates in the !Run file can be set to point to a
  48. directory holding the templates files - a good place is the RAM disk or
  49. !Memphis so the disk (hard or soft) will not be accessed on every resolution
  50. change (it also won't be if only sys`font is used)
  51.  
  52. If V+F$Templates is *Unset, templates will be searched for in V+F's directory
  53.  
  54.  
  55. Colours
  56. =======
  57.  
  58. If you redefine the
  59.  
  60. 1) View window's foreground
  61. 2) highlighting
  62. 3) non-displayable ('control') characters
  63.  
  64. colour, set the corresponding variable in the mk`ARMCode to the new value
  65.  
  66. 1) color`foreground
  67. 2) color`hiLite
  68. 3) color`ctrlCh
  69.  
  70. and run mk`ARMCode. It will MaKe a new ARMCode and save it into
  71.  
  72. scrap`dir$+"ARMCode"    (scrap`dir$="RAM:$." currently, note the '.')
  73.  
  74. Replace the old ARMCode by the new one or you won't see any changes
  75. (in the best case) or anything at all (in the less better one)
  76.  
  77. Current values for the above colours are 0,14,11 = white,orange,red
  78.  
  79.  
  80. Problems
  81. ========
  82.  
  83. The Save icon is set up to darken slightly when it slabs inwards.
  84. This works ok with the system font but with aa fonts it doesn't change
  85. the colour when slabbing in and the next time you open the Configure window
  86. 'Save' will have disappeared leaving only the icon border.
  87. I don't know whether this is a bug in the Interface module or in me
  88. Anyway, this is not as bad as it seems as the icon comes back as healthy as
  89. possible on a resolution change
  90.  
  91. Maybe some more ...
  92.  
  93.  
  94. Help
  95. ====
  96.  
  97. ... is in the DrawFiles. 'Read' them in the order
  98.  
  99. view`state
  100. find`state
  101. conf`state
  102. icon`state
  103. last`state
  104.  
  105. or in any other sensible one. If you load them in mode 12 and full size'em
  106. you will already see everything they contain, ie. you don't need to scroll
  107. around to see more
  108.  
  109. I also include the old ReadMe file but since some new things have appeared
  110. and some old ones dis, compare with the `state files
  111.  
  112.  
  113. Franz Philipps
  114. Koeslinerstr. 71 A
  115. 7500 Karlsruhe
  116. Germany
  117.  
  118. e-mail: ig06@rz.uni-karlsruhe.de
  119.  
  120.  
  121. - ReadMe old -------------------------------------------------------------------
  122.  
  123.  
  124. !View+Find  let's you
  125.   ^    ^
  126.   |    |
  127.   +------------ view a file
  128.        |
  129.        +------- search it for a string
  130.  
  131.  
  132. V+F displays a file as follows:
  133.  
  134. A line is broken at an End Of Line (EoL) char or
  135. when it has reached a maximum length of 80 chars
  136.  
  137. EoL is CHR$10 or CHR$13 depending on which one was found first
  138. when searching from the beginning of the file (of course)
  139.  
  140. CHR$9 (tab) is replaced by as much spaces as needed to arrive
  141. at an 8-char boundary (you know what I mean)
  142.  
  143. The delete char (127) control chars (codes < 32) which are not
  144. EoL or tab get ASC"@" added to them and are displayed in red,
  145. so a RED ¿ is the del char ( ASC"¿" - ASC"@' = 191-64 = 127 )
  146. and a white ¿ is what it is: a ¿ in white
  147.  
  148. Only the normal chars are displayed normally
  149.  
  150. All this happens in the View window, the one in the middle
  151. of the DrawMe file which you should load into !Draw now and
  152. continue there (I got tired looking up every (well, almost)
  153. word in my E<>G dictionary; besides, 1 pic is better than 1000)
  154.  
  155. ( If you don't have !Draw, load it into !Draw+
  156.   If you don't have !Draw+, you're trying to run the right program
  157.   on a wrong computer )
  158.  
  159.  
  160. Here goes the summary and some things which are not in the DrawMe file:
  161.  
  162. (BUTTON+SHIFT means of course: hold SHIFT down while clicking button BUTTON)
  163.  
  164.  
  165. Killing the Caret
  166. -----------------
  167. SELECT+SHIFT over View
  168. SELECT+SHIFT over Icon
  169.  
  170.  
  171. Opening
  172. -------
  173. Search for: MENU over View
  174.             (opens up at a position according to
  175.              the state of the Configure window)
  176. Configure : MENU+SHIFT over View
  177.             (opens just below the title of 'its' View window)
  178. Icon      : close View with ADJUST (opening Icon = iconizing View)
  179. View      : MENU over Icon
  180.  
  181.  
  182. Closing
  183. -------
  184. Search for: if already open, MENU over View closes it
  185.             it dies with View
  186.             and it's an 'if you lose the caret you lose your life' window
  187.             (so it'll be closed when View gets iconized or when a writeble
  188.              icon or another window grabs the caret)
  189. Configure : any button over View
  190.             it also is a iyltcylyl window
  191. Icon      : MENU over it (closing Icon = deiconizing View)
  192.             +SHIFT terminates the program
  193. View      : ADJUST iconizes it
  194.             SELECT - normal action (kills !View+Find also)
  195.             +SHIFT opens directory of the file being viewed
  196.  
  197.  
  198. Input focus
  199. -----------
  200. Configure and 'Search for' are panes with View as their tool window
  201. (this is how Arthur calls it). They get the I.focus when being opened up
  202. and View gets highlighted green (hoping for something ?)
  203.  
  204.  
  205. Scrolling View
  206. --------------
  207. normal + Cursor keys
  208. Page Up/Down = SHIFT + Cursor Up/Down
  209. ^ Cursor Up/Down do what you'd expect
  210.  
  211.  
  212. Moving around
  213. -------------
  214. Search for: title bar
  215. Configure : "
  216. Icon      : SELECT anywhere over it brings it to the top first
  217.             ADJUST anywhere over it ; current position is retained
  218.             ADJUST+SHIFT anywhere over it sends it to the bottom first
  219. View      : as Icon
  220.  
  221.  
  222. Shortcuts
  223. ---------
  224. These will only work if they come through.
  225.  
  226. For example, if you're editing something with a strong editor in a
  227. YELLOW window, f4 will bring up the 'Find text' dialog box.
  228. Now you kill the caret (SELECT+SHIFT in View), the window pales
  229. and f4 brings forth the 'Search for' window.
  230.  
  231. Shortcuts are 'context sensitive' (e.g. f4 only works when View's open)
  232.  
  233. f4 see ⇧
  234. ^I(conize)    iconizes View
  235. ^C(ase)       toggles Case sensitivity when 'Search for' is open
  236.   (onfigure)  opens Configure otherwise
  237. ^K(ill)       terminates the program
  238. ^V(iew)       deiconizes View
  239.  
  240. RETURN is equivalent to clicking on the Save button of Configure
  241.        or triggers a search ⇩ when in 'Search for'
  242.  
  243. ESCAPE will kill Search for and Configure
  244.  
  245.  
  246. Searching
  247. ---------
  248. CURSOR ⇩ searches to the end of file
  249. CURSOR ⇧          to its head
  250.  
  251. The search starts at first displayed line or at the last match if
  252. it is visible (ORANGE highlighting) and wraps at both ends.
  253. If you scroll a visible hiLiting out of sight the first line will be taken.
  254. A short melody will be played if nothing or the privious match
  255. has been found. So,
  256. - looking for 'b' in 'abba' will hiLite the 1st 'b' (found) and if
  257.   you press RETURN of CURSOR ⇩ the second one gets hiLited
  258. - looking for 'b' in 'aba' will hiLite the 1st 'b' (found) and if
  259.   you press RETURN of CURSOR ⇩ it will be found again (wrap at bottom),
  260.   but as this is the previous match, the heavenly melody will sound
  261.  
  262. To switch from 'Not case sensitive' to 'Case sensitive' click on
  263. 'Not case sensitive' with SELECT or ADJUST (or ^C)
  264. To switch from 'Case sensitive' to 'Not case sensitive' click on
  265. 'Case sensitive' with SELECT or ADJUST (or ^C)
  266.  
  267. If you enter '\*' V+F will find it if it's there
  268.  
  269.  
  270. (Oh Mann, it gets pretty long)
  271.  
  272.  
  273. Defaults
  274. --------
  275. A default State file will be generated if there isn't one:
  276. - Iconize View at last position
  277. - don't tie 'Search for' to View
  278.  
  279. 'Iconize View at last position' means:
  280. - iconize View to Icon
  281. - place Icon at its last position
  282.  
  283. In the beginnig there wasn't a last position ...
  284.  
  285. So, so configured, the first time you iconize View Icon will be placed at a
  286. random position somewhere at the left screen edge in the upper screen half
  287.  
  288.  
  289. I may have forgotten a thing - click around wildly with modifier keys
  290. held down to find out
  291.  
  292.  
  293. Here's how I use it (could be useful perhaps)
  294.  
  295. I have defined several new file types (ViewFile, §Index, §Manual, §Info,
  296. §Warning) with nice sprites corresponding to their names and
  297.  
  298. *Set Alias$@RunType_XYZ /!View+Find.Run %0
  299.  
  300. That's ok until you want to view files of other types
  301. Then you need a Strong Ed or a not so strong one
  302.  
  303. OR
  304.  
  305. You run !TinyDirs (are you PC guy still here ?) and pull V+F to the
  306. directory icon on the icon bar. Now you can view files of type >-1 and <&1000
  307. - just drop one on V+F's icon.
  308.  
  309. (I hold V+F in !Memphis together with ResoIcons' sprites and have
  310. *Set Run$Path Mem:$.,etc. so disk is accessed only to get the view file
  311. and I can do with the ram disk whatever I want and as a side effect
  312. easily determine who's abusing the system sprites area and wants to
  313. be dragged to Richard € Immediate (sits just beside Brian) )
  314.  
  315.  
  316. Eh ...
  317.  
  318. Some sprites are not mine:
  319.  
  320. The Eye I took from ARXE's Scorpius (don't know from whom they did)
  321.  
  322. The Skull is from Fillip 1988-1989 who wrote !Fish
  323. (Scorpius' skull is much nicer but how get it ?)
  324.  
  325. The Glasses I extracted from one on those uncountable Sprites/3dIcons/3dSprites
  326. etc. archives months ago so I really don't know who designed it
  327.  
  328.  
  329. All modules aren't too:
  330.  
  331. The Interface module is by Simon Huntington (but who doesn't know this)
  332.  
  333.  
  334. Ok, that's all
  335.  
  336. I hope it won't do any harm to your Archimedes
  337.  
  338. Bye
  339.  
  340. Franz Philipps
  341.  
  342. ig06@rz.uni-karlsruhe.de
  343.  
  344. ⇧ send me your bugs but only mine
  345.